GETC
Section: Standard I/O Functions (3S)
Updated: May 14, 1986
Index
Return to Main Contents
NAME
getc, getchar, fgetc, getw - get character or word from stream
SYNOPSIS
#include <stdio.h>
int getc(stream)
FILE
*stream;
int getchar()
int fgetc(stream)
FILE
*stream;
int getw(stream)
FILE
*stream;
DESCRIPTION
Getc
returns the next character from the named input
stream.
Getchar()
is identical to
getc(stdin).
Fgetc
behaves like
getc,
but is a genuine function, not a macro;
it may be used to save object text.
Getw
returns the next
int
(a 32-bit integer on a VAX-11) from the named input
stream.
It returns the constant
EOF
upon end of file or error, but since that is a good
integer value,
feof
and
ferror(3S)
should be used to check the success of
getw.
Getw
assumes no special alignment in the file.
SEE ALSO
clearerr(3S),
fopen(3S),
putc(3S),
gets(3S),
scanf(3S),
fread(3S),
ungetc(3S)
DIAGNOSTICS
These functions return the integer constant
EOF
at end of file, upon read error,
or if an attempt is made to read a file not opened by
fopen.
The end-of-file condition is remembered,
even on a terminal,
and all subsequent attempts to read will return
EOF
until the condition is cleared with
clearerr(3S).
BUGS
Because it is implemented as a macro,
getc
treats a
stream
argument with side effects incorrectly.
In particular,
`getc(*f++);'
doesn't work sensibly.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- SEE ALSO
-
- DIAGNOSTICS
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 04:51:47 GMT, January 31, 2023